home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / internet / blat15i.zip / README < prev   
Text File  |  1996-04-17  |  7KB  |  166 lines
  1. INDEX
  2.  
  3.  - description
  4.  - installation
  5.  - what's new in this version
  6.  - usage
  7.  - examples
  8.  - future improvements
  9.  - copyright
  10.  - authors
  11.  - contributors
  12.  
  13.  
  14. DESCRIPTION:
  15.  
  16. Blat is a Public Domain (generous aren't we?) Windows NT console utility that
  17. sends the contents of a file in an e-mail message using the SMTP protocol.
  18. Blat is useful for creating scripts where mail has to be sent automatically
  19. (CGI, backups, etc.) To use Blat you must have access to a SMTP server via
  20. TCP-IP. Blat uses the a DLL ("gensock" or "gwinsock") from WinVN, the public
  21. domain usenet newsreader for windows. Blat can store a default SMTP server
  22. address and a default "From:" field in the registry. The server's address can
  23. be overriden using the -server flag, and the "From:" address using the -f
  24. flag. Input from the console (stdin) can be used instead of a disk file (if
  25. the special filename '-' is specified). Blat can also "carbon copy" and
  26. "blind carbon copy" the message. Impersonation can be done with the -i flag
  27. which puts the value specified in the "From:" line, however when this is done
  28. the real senders address is stamped in the "Reply-To:" and "Sender:" lines.
  29. This feature can be useful when using the program to send messages from NT
  30. users that are not registered on the SMTP host.
  31.  
  32.  
  33. INSTALLATION:
  34.  
  35. If you are upgrading from version 1.3, 1.4 or 1.5 beta, simply copy Blat.exe 
  36. over the old one.
  37.  
  38. If you are upgrading from version 1.2 then copy the new Blat.exe over the old
  39. one and (optionally) substitue gensock.dll with gwinsock.dll. The new DLL is
  40. used if found on the path, if not Blat tries to load the old one (the new one
  41. is more efficient though).
  42.  
  43. If you are upgrading from Blat 1.1 or 1.0 (phew!) or you never used Blat before
  44. you must follow these steps:
  45.  
  46. 1) Copy the file "gwinsock.dll" to your "\WINNT\SYSTEM32" directory, or to any
  47.    other directory in your path. (Check if you already have it and only copy
  48.    the DLL if the date is more recent than the existing one)
  49.  
  50. 2) Copy the file "Blat.exe" to your "\WINNT\SYSTEM32" directory, or to any
  51.    other directory in your path.
  52.  
  53. 3) Run "Blat -install yourhost.site.blah.blah youruserid@site.blah.blah"
  54.  
  55. WHAT'S NEW IN THIS VERSION
  56.  
  57.  - Two bugs were corrected that made Blat generate exceptions with certain 
  58.    CC or BCC adresses. 
  59.  - Blat now generates descriptive error messages, rather than the infamous 
  60.    "gensock error 4017" type errors 
  61.  - Blat now returns an error code when the SMTP session fails 
  62.  - A new option -mime was added. This implements the possibility to use 
  63.    the MIME quoted-printable transfer encoding. The assumptions are: 
  64.         1: The file is a text file 
  65.     2: The charset is ISO 8859/1
  66.  
  67.  
  68. USAGE: 
  69.  
  70. syntax:
  71. Blat <filename> -t <recipient> [optional switches (see below)]
  72. Blat -install <server addr> <sender's addr> [-q]
  73. Blat -h [-q]
  74.  
  75. -install <server addr> <sender's addr>: set's default SMTP server and sender
  76.  
  77. <filename>    : file with the message body ('-' for console input, end with ^Z)
  78. -t <recipient>: recipient list (comma separated)
  79. -s <subj>     : subject line
  80. -f <sender>   : overrides the default sender address (must be known to server)
  81. -i <addr>     : a 'From:' address, not necessarily known to the SMTP server.
  82. -c <recipient>: carbon copy recipient list (comma separated)
  83. -b <recipient>: blind carbon copy recipient list (comma separated)
  84. -h            : displays this help.
  85. -mime         : MIME Quoted-Printable Content-Transfer-Encoding.
  86. -q            : supresses *all* output.
  87. -server <addr>: overrides the default SMTP server to be used.
  88.  
  89. Note that if the '-i' option is used, <sender> is included in 'Reply-to:'
  90. and 'Sender:' fields in the header of the message.
  91.  
  92.  
  93. EXAMPLES:
  94.  
  95. Blat -install smtphost.bar.com foo@bar.com          // Sets host and userid
  96. Blat -install smtphost.bar.com foo                  // Sets host and userid
  97. Blat -install smtphost.bar.com                      // Sets host only
  98.  
  99. Blat myfile.txt -s "A file for pedro" -t foo@bar.com
  100. // Sends a file with subject line "A file for pedro"
  101.  
  102. Blat myfile.txt -s "A file for pedro" -t foo@bar.com -q
  103. // Sends a file with subject line "A file for pedro" and does not print
  104. // informative messages on the console
  105.  
  106. Blat myfile.txt -s "A file for mark" -t fee@fi.com -f foo@bar.com
  107. // -f option overrides the default sender
  108.  
  109. Blat myfile.txt -s "A file for pedro" -t foo@bar.com -i "devil@fire.hell"
  110. // -i replaces "From:" line address (but leaves Reply-To: and Sender: lines)
  111.  
  112. Blat myfile.txt -s "animals" -t fee@fi.com -c "moo@grass.edu,horse@meadow.hill"
  113. // -c mails carbon copies to users moo@grass.edu and horse@meadow.hill
  114.  
  115.       
  116. FUTURE IMPROVEMENTS (you can do it!)
  117.  
  118. 1) reorganize the code (fat chance!)
  119. 2) get rich (fat chance!)
  120. 3) go on holidays... (done: Sri Lanka, NZ, Portugal, France, Denmark)
  121. 4) go on holidays again... (any offers?)
  122.  
  123.  
  124. COPYRIGHT
  125.  
  126. License to use Blat
  127.  
  128. The authors of Blat have placed it in the public domain. This means you
  129. can use it free of charge for any purpose you like, with no conditions being
  130. placed on its use by us. The source code is also available free of charge and
  131. under the same conditions as the executables.
  132.  
  133. You have permission to modify, redistribute, hoard, or even sell Blat in its
  134. executable or source form. If you do sell Blat, though, we'd appreciate it if
  135. you'd provide your own support (and send us a free copy).  We cannot take any
  136. support load for Blat (we've got better things to do). 
  137.  
  138. Various bits of the source code are copyright by other people/organizations.
  139. Look in the source code for copyright ownership.
  140.  
  141. The authors of the package are not responsible for any damage or losses that
  142. the usage of Blat may cause. We are especially not responsible for the misuse
  143. of the SMTP (or other) mail system.
  144.  
  145.  
  146. AUTHORS
  147.  
  148. Mark Neal    (mjn@aber.ac.uk)
  149. Pedro Mendes (prm@aber.ac.uk)
  150.  
  151.  
  152. CONTRIBUTORS
  153.  
  154. We'd like to thank:
  155.  
  156. the WinVN team                       - wrote gensock.dll and the excellent WinVN
  157.                                        newsreader from which we copied most of
  158.                                        Blat's code (PD apps are nice!)
  159. Beverly Brown (beverly@datacube.com) - fixed the argument parsing
  160. Bob Beck (rbk@ibeam.intel.com)       - added console input (even though we did
  161.                                        not use his code in the end...)
  162. Axel Skough (axel.skough@scb.se)     - added the MIME code, fixed the CC/BCC
  163.                                        bug and added the return code
  164.  
  165.  
  166.